home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Tampa Bay Amiga Group / TBAG - Tampa Bay Amiga Group's Disk of the Month #49 (1990)(Merlin's Software - Amiganuts United)(PD).zip / TBAG - Tampa Bay Amiga Group's Disk of the Month #49 (1990)(Merlin's Software - Amiganuts United)(PD).adf / Docs / Formatter.docs < prev    next >
Text File  |  1990-11-15  |  9KB  |  193 lines
  1. ========================== Formatter 2.4a ============================
  2. ======================================================================
  3. A  floppy  disk formatting program, written by Olaf 'Olsen' Barthel of
  4. MXM.   Copyright,  © 1990 by MXM.  Shareware, all rights reserved.  No
  5. guarantee  of  any  kind is made that the program(s) described in this
  6. document are 100% reliable.  You use this material on your own risk.
  7.  
  8. ============================== Purpose ===============================
  9. ======================================================================
  10. The  standard  'format'  command surely does a brilliant job, since it
  11. gets  around  with  any device driver and partitions of any size.  But
  12. which  data media is formatted most oftenly?  Floppy disks (3½" format
  13. hardwired  to  the  Amiga  computer)  of  course. 'Formatter 2.4a' was
  14. written  to fit the niche for fast(er) and user friendlier floppy disk
  15. formatting  programs.   It  also  shows  how to format file systems in
  16. general and how to get AmigaDOS to accept them.
  17.  
  18. =============================== Usage ================================
  19. ======================================================================
  20. 'Formatter  2.4a'  can  be  called both from Shell and Workbench. Note
  21. that arp.library is required to run the program (Yuck!).
  22.  
  23.          The following command line parameters are supported:
  24.  
  25. DRIVE/A........    This can be any disk drive from DF0:  through DF3:  as
  26.         long  as it's really connected.  You will get an error
  27.         message  if  the  disk  drive  cannot  be found in the
  28.         current DOS mountlist.
  29.  
  30. NAME/K.........    The  name you wish the formatted disk to receive.  Any
  31.         name longer than 31 characters will be truncated.
  32.  
  33. FAST/S.........    No  secret  fast formatting tricks yet, this option is
  34.         similar to the 'QUICK' switch of the standard 'format'
  35.         command:   if enabled only the root block and the boot
  36.         block  of  the  disk  will  be rewritten (clearing all
  37.         relevant  data).   If  your  disks  have  already been
  38.         formatted clearing those blocks can save much time.
  39.  
  40. INSTALL/S......    If  you  want  to use the formatted disk as a bootable
  41.         AmigaDOS disk,'Formatter 2.4a' will install it just as
  42.         if you had used the AmigaDOS 'Install' command on it.
  43.  
  44. VERIFY/S.......    If   enabled,  each  write  access  to  disk  will  be
  45.         verified,  i.e.  the disk blocks being written will be
  46.         reread and compared with the source data.  Needless to
  47.         say,  verification  slows  down  the  disk  formatting
  48.         process  but  helps  to  tell  the good disks from the
  49.         corrupt ones.
  50.  
  51. AUTOSTART/S....    If enabled, any disk inserted into the specified drive
  52.         will be formatted automatically.  This saves some time
  53.         if  lots  of  disks have to be formatted one after the
  54.         other.
  55.  
  56. FFS/S..........    In  behalf of the new Kickstart release, the fast file
  57.         system  is  supported  as well.  The disk receives the
  58.         FFS IDs where the standard format program places them.
  59.  
  60. A  small  window  will pop up on the Workbench screen (right under the
  61. mouse  pointer  if  possible).   The window will look like this (well,
  62. roughly, I never claimed being a graphic artist, did I?):
  63.  
  64.       #X#Formatter2.4a=====================##|##
  65.       |..   ..   ..   ..   ..   ..   ..   ..   | <- Track numbers
  66.       ||    |    |    |    |    |    |    |    |
  67.       |----------------------------------------|
  68.       |                                        | <- Process indicator
  69.       |------------+--+-------------+----------|
  70.       | Auto start |  | Fast format |          | <- Some gadgets
  71.       |------------+  +-------------+   Start  |
  72.       |Verify write|  |Install disk |          | <- Some more gadgets
  73.       |--------+-+-+------+-+-------++ +-------|
  74.       |  DF0:  | |  DF1:  | |  DF2:  | |  DF3: | <- Drive selection
  75.       |--------+ +--------+ +--------+ +-------|
  76.       |         +------------------------------|
  77.       | Name:   | Blank                        | <- Name string gadget
  78.       |         +------------------------------|
  79.       +----------------------------------------+
  80.  
  81. Control  should  be  intuitively  (why  shouldn't  it,  you're running
  82. Intuition  anyway, aren't you?), if you've understood the command line
  83. options  (to  which  the gadgets somehow correspond to) you should get
  84. along with the rest of the program easily.
  85.  
  86. ========================= Keyboard shortcuts =========================
  87. ======================================================================
  88. To  make  life  easier,  each  gadget  in  the  control  window can be
  89. enabled/toggled  via  keyboard.  These shortcuts are supported through
  90. the Intuition menu attached to the 'Formatter 2.4a' window.
  91.  
  92. About...         (-> ?)    Display a short program info.
  93. Auto start        (-> A)    Toggle auto-start option
  94. Fast format        (-> F)    Toggle fast formatting
  95. Verify write        (-> V)    Toggle write verification
  96. Install disk        (-> I)    Toggle disk installation
  97. Use FFS            (-> U)    Toggle FastFileSystem support
  98.  
  99. Drive DFx:        (1..4)    Select a disk drive to be formatted
  100. Start formatting    (-> S)    This should speak for itself
  101. Quit            (-> Q)    Close the window and leave the program
  102.  
  103. ====================== Formatter 2.4a vs. format =====================
  104. ======================================================================
  105. 'Formatter  2.4a' is  limited to the 3½" drives hardwired to the Amiga
  106. computer, no other filesystems will be formatted (I haven't tried yet,
  107. but  I  suppose that 5¼" drives won't be formatted either).  The disks
  108. will  be  formatted  using  either the old standard file system or the
  109. FastFileSystem.
  110.     Formatting  time  is  well  below  the  time  'format'  needs;
  111. formatting  a  disk without verify takes between 47 and 50 seconds, if
  112. verify  is enabled formatting will take between 1:36 and 1:40 minutes.
  113. The  step  delay  of the drive motors is not touched, nobody knows how
  114. the  different  drives  by  various  manufacturers  react on different
  115. rates.
  116.  
  117. ============================== Credits ===============================
  118. ======================================================================
  119. Credits  go  to  Mark Rinfret for the very, very basic disk formatting
  120. routines  employed  by his harddisk backup program.  It took some time
  121. to  spy out the default disk format information.  The block types were
  122. picked  up  both  from  Ralph Babel's 'Amiga Guru' book and the Bantam
  123. AmigaDOS Programmers' manual.
  124.  
  125. =============================== Author ===============================
  126. ======================================================================
  127. This  program was written by Olaf Barthel of MXM.  All files have been
  128. placed in the public domain.  You may freely distribute this material,
  129. even  a  small  copy  fee  is  okay  but  everything  which looks like
  130. commercial distribution is forbidden.  Still you may use this material
  131. for software development without giving credit to the original author.
  132.  
  133. The  program  and the accompanying files are distributed as Shareware.
  134. If  you  like  'Formatter 2.4a'  and use it frequently, please send at
  135. least  7  US$  or  DM 15,- to cover our media costs.  If you enclose a
  136. self  adressed  (and  stamped)  envelope (note:  Germany only, for all
  137. other  countries  enclose  postage  separately)  you  will receive new
  138. material and updates from MXM.
  139.  
  140. Send   new   program  revisions,  comments,  bug  reports,  donations,
  141. unmarried   sisters,   non-poisoned   candy,  home-grown  palm  trees,
  142. horoscopes, promising capital investments, etc.  to:
  143.  
  144.                           Olaf Barthel, MXM
  145.                           Brabeckstrasse 35
  146.                           D-3000 Hannover 71
  147.  
  148.                      Federal Republic of Germany
  149.  
  150. ============ Revision history (most recent change first) =============
  151. ======================================================================
  152. V2.4a    Very  much  the same as Formatter 2.4, different only in parts
  153.     of  the  user  interface.   The  older  release did not handle
  154.     menus/gadgets correctly.
  155.  
  156. V2.4    The  bootblock  installation  process  obviously never worked,
  157.     this  has  been  fixed.   Funny  enough,  if  several disk I/O
  158.     requests   were   queued,  the  root  track  was  not  written
  159.     correctly.  This occured particularly often on Turbo-Amigas or
  160.     A3000  computers.   Holger  Lubitz  suggested  that  the disks
  161.     should  be  validated  after  the  formatting process.  If two
  162.     Formatters  were  run simultaneously, the disk validator could
  163.     accidentally  modify the contents of the rootblock.  All known
  164.     other errors have been fixed.
  165.  
  166. V2.3    The disk formatting and verification process have been sped up
  167.     greatly.  The  disk  root  block  is written during formatting
  168.     rather than after it.  The data on disk will be verified after
  169.     the  disk  has been formatted and will start at track 79 going
  170.     down to track 0.
  171.  
  172.     There   is   a  debug  switch  available  from  Shell.   If  a
  173.     verification  error occurs, both track buffers will be written
  174.     to RAM:.
  175.  
  176. V2.2    Added  a  menu  and  FastFileSystem  support.   Applied  small
  177.     changes to the code to make the program work smoother.
  178.  
  179. V2.1    Removed  a  bunch of suspicious code passages which caused the
  180.     various  gadgets  to  get  mixed  up  by the message broadcast
  181.     system.
  182.  
  183. V2.0    A complete rewrite  of  the  original  program,  first  public
  184.     release.
  185.  
  186. V1.0    A very limited disk formatting program.
  187.  
  188.                                   *
  189.  
  190.              Do only its possibilities make it an Amiga?
  191.  
  192.                         WHERE IS THE MAGIC ???
  193.